home *** CD-ROM | disk | FTP | other *** search
/ Suzy B Software 2 / Suzy B Software CD-ROM 2 (1994).iso / picmanip / pic_r2z / sul2spu / sul2spu.doc < prev    next >
Text File  |  1995-05-05  |  11KB  |  247 lines
  1.  
  2.                                RayVerter  v1.00
  3.                                  Documentation
  4.  
  5.                          Released on February 2, 1992
  6.  
  7.                      (C)1992 by Lonny L. Pursell and Encom
  8.                               All Rights Reserved
  9.  
  10.  
  11.  
  12.  
  13. Archive Contents
  14. ----------------
  15.  
  16. This archive should contain the following files.
  17.  
  18.   SUL2SPU.PRG    the utility program itself
  19.   SUL2SPU.DOC    this doc file
  20.   SPSLIDEX.PRG   Spectrum 512 slide show utility (use this to view pics)
  21.   RAYTRACE.TXT   text file by Nick Smith (included with permission)
  22.                  contains important info for any GFA Raytrace user
  23.  
  24.  
  25. Introduction
  26. ------------
  27.  
  28.     This program will convert GFA Raytrace files into Spectrum 512 files.
  29. GFA Raytrace uses it's own file format which until recently was a
  30. complete mystery.  GFA Raytrace is capable of generating some very
  31. stunning raytraced images, but due to it's file incompatabilities the
  32. output was all but useless in my mind.  GFA does not include any printer
  33. or file conversion utilities with GFA Raytrace.  Well, the only way to use
  34. your newly created images was to wait for someone to come along and write
  35. a conversion utility.  I was waiting myself!  Well, if you are one of
  36. those people waiting for such a program then your wait is over, as you
  37. have probably discovered perphaps the only GFA Raytrace picture converter.
  38.  
  39.     Now let's get serious for a while.  The first point I want to make
  40. is this.  Just because I have released a conversion utility of this nature
  41. doesn't mean you should give up on GFA Raytrace being updated.  I urge
  42. you to write GFA and ask them to update the program.  Tell them what you
  43. want to have added and/or fixed before it's too late.  GFA seems to be 
  44. ignoring the program and the people who purchased it.  One particular 
  45. person who I will mention is Nick Smith, he has been trying to get the 
  46. needed documentation for this type of conversion utility for some time. 
  47. Without Nick Smith you wouldn't be reading this docs file, he was the
  48. one who urged me to finish the program.  As it turns out I managed
  49. to figure out the file format without the help of GFA, so they might
  50. as well release the specs now as it is no secret anymore.
  51.  
  52.    Included in the package is a text file written by Nick Smith.  This
  53. is the same text file that prompted me to contact Nick and I urge all 
  54. GFA Raytrace users to read it.
  55.  
  56.      This documentation will focus primarily on the operation of this
  57. program; it's not intended to teach you how to create and/or read the
  58. picture file formats used by the program.
  59.  
  60.  
  61. This program is ShareWare!
  62. --------------------------
  63.  
  64.     Now, before you get to excited I must first tell you that my
  65. ShareWare adventures have be less then what I expected.  That's not to
  66. say I havn't gotten any replies, I have, but I think the numbers should
  67. be a little higher than they are.  In an attempt to over come the
  68. problem I decided to try an approach used by other ShareWare authors.
  69.  
  70. The program you are about to use is somewhat less than perfect.  That's
  71. not to say it doesn't work as advertised, in fact it does work as
  72. advertised but with one small catch.  The Spectrum 512 pictures it
  73. outputs are not easily touched up in Spectrum 512, but look ok when
  74. viewed from a slide show.  If you want to output Spectrum pics which are
  75. fully compatible with Spectrum 512 then you'll have to register the
  76. program.  After registering, a full working version will be sent to
  77. you.  I didn't want to do it this way, but I think it's for the best.
  78.  
  79.      If by some chance you are given or download a registered version of
  80. RayVerter (not registered to you) please forward it me stating the source
  81. of the copy or destroy it yourself!  Thanks.
  82.  
  83.      All versions of this program are 'ShareWare', this means that if
  84. you decide to use it you're expected to pay for it.  You pay for the
  85. commercial programs use, right?  Why not pay for the ShareWare you
  86. use as well?  Rememeber, ShareWare doesn't happen by accident.  The
  87. author spent time writing the software and relies on your honesty
  88. as an Atari Computer owner.
  89.  
  90. The registration fee is $5.00 ... or send what you think it's worth.
  91.  
  92.      If you do decide to use it, please send a check or money order
  93. in U.S. funds to...
  94.  
  95.                            Lonny L. Pursell
  96.                            ATTN: RayVerter
  97.                            P.O. Box 145
  98.                            Pandora, OH  45877
  99.  
  100.      I thank you for your support!  Please remember, if you want to see
  101. more ShareWare programs like this, you have to do your part and pay for
  102. the ShareWware programs you use.
  103.  
  104.  
  105. Using the program
  106. -----------------
  107.  
  108.     Runs in low or medium resolution only.
  109.     Reads GFA Raytrace 'SUL' uncompressed files only.
  110.       You must first uncompress the file you wish to convert.  To do this
  111.       you need to load GFA Raytrace and turn off the 'Compression' feature
  112.       under the 'Status' option from the editor.  Load the picture and
  113.       then resave it and it will be uncompressed.
  114.     Writes Spectrum 512 'SPU' uncompressed files only.
  115.  
  116. To use the program either:
  117.  
  118. 1)  Install the program as an application on the GEM Desktop with a file
  119.     type of 'SUL' and then save the Desktop information.  Double-click
  120.     on the GFA Raytrace 'SUL' file you wish to convert.  The 'SUL' file
  121.     you clicked on will then be loaded and converted.  The 'SPU' file will
  122.     always be written to the same directory as the source file.
  123.       Example:  Input> D:\PICS\ROOM3D.SUL
  124.                Output> D:\PICS\ROOM3D.SPU
  125.     After saving the 'SPU' file you will be return to the GEM Desktop.
  126.  
  127.  
  128. 2)  Double-click on the program from the GEM Desktop.  The file selector
  129.     will appear so you can select the GFA Raytrace 'SUL' file you wish to
  130.     convert.  The 'SUL' file you selected will be loaded and converted.
  131.     When it's done it will be displayed in Spectrum 512 mode.  Press
  132.     any key when you are done viewing the picture.  An alert box will
  133.     appear asking you if you want to save the 'SPU' file.  You have three
  134.     options:
  135.        1) Write the 'SPU' file to the default directory.
  136.        2) Use the file selector to save the 'SPU' file to a specific
  137.           directory.
  138.        3) Abort the save.
  139.     Once you've made your slection the program will save the 'SPU' file
  140.     and cycle back to the beginning so you can convert another 'SUL'
  141.     file.  Selecting 'Cancel' in the file selector when prompted for a
  142.     'SUL' file exits the program and returns you to the GEM Desktop.
  143.  
  144.  
  145. These option are valid no matter how you execute the program.
  146. The 'SUL' file you selected will be loaded and displayed.  This program
  147. converts the 'SUL' file in one pass.  You can peek in on it's progress at
  148. anytime by pressing the space bar which causes the program to display the
  149. picture in Spectrum 512 mode.  Leaving the 512 color mode on slows done
  150. the conversion!  Pressing the space bar again shuts off the 512 color
  151. mode.  Pressing escape aborts the conversion without saving.  After the
  152. picture is completed a bell will ring.  Due to the differences in the
  153. file formats it's possible the output picture won't look exactly like the
  154. input file.  RayVerter attempts to retain as much of the original picture
  155. as possible, infact most pictures are pixel for pixel copies while others
  156. are slightly averaged.
  157.  
  158. NOTE: If an error is detected all open files will be closed, and you will
  159.       be alerted and return to the GEM Desktop.  
  160.  
  161.  
  162. About the program
  163. -----------------
  164.  
  165.     This program was written with GFA Basic 3.6TTe on a stock Mega ST2
  166. with TOS 1.4 and a SC1224 color monitor.  I can't say for sure if it
  167. will run on lesser or newer machines, but it should as long as the
  168. machine you run it on supports Spectrum 512.  Since I wrote the program
  169. without any docs on the GFA Raytrace file format it's possible I over
  170. looked something important.  If anyone has any scrap of info on the
  171. file format I would like to see it.  Future version might read compressed
  172. GFA Raytrace files and perphaps write GIF files or other formats that
  173. can better retain all the colors.  Please contact me if you have an docs
  174. on GIF, GFA Raytrace, or Spectrum you would like to send my way.
  175.  
  176.  
  177. User Support
  178. ------------
  179.  
  180.     If you have an idea for a feature or want to report a bug (if any)
  181. then by all means contact me.  Please include the full name and
  182. version# of the program you are refering to.  If your not a registered
  183. user I'll read your replies, but don't expect me to take you serious.
  184. On the other hand if you are a registered user I want to hear from you
  185. and I'll make an honest effort towards whatever is required.
  186.  
  187.     I can be reached by U.S. Mail at this address...
  188.  
  189.                           Lonny L. Pursell
  190.                           ATTN: RayVerter
  191.                           P.O. Box 145
  192.                           Pandora, OH  45877
  193.  
  194.                           Tel: (419)-384-3594 [ask for Lonny]
  195.  
  196.     I can also be reached on my FAVORITE multi-line BBS...
  197.  
  198.                           CodeHead Quarters BBS
  199.                           (213)-461-2095
  200.                           1200/2400/9600 baud
  201.                           Username: Lonny Pursell
  202.  
  203.  
  204. I'd like to Thank
  205. -----------------
  206.  
  207. Nick Smith for urging me to finish the program and making me aware of the
  208. fate of GFA Raytrace.
  209. Trio Engineering for releasing the Spectrum 512 load/display modules and
  210. the documention needed to create such images.
  211. I'd like to thank GFA, but I cannot.
  212.  
  213.  
  214. Acknowledgments
  215. ---------------
  216.  
  217. Atari, ST, Mega ST, STE, and TT are trademarks of Atari Corp.
  218. GEM, GEM Desktop, and DRI are trademarks of Digial Reasearch Inc.
  219. GFA and GFA Basic are trademarks of GFA Systemtechnik
  220. GFA Raytrace is copyright (C)1989 by GFA Data Media Ltd.
  221. Spectrum 512 is copyright (C)1987 by Trio Engineering, Inc.
  222. All other items are copyrighted/trademarked by their respective owners
  223.  
  224.  
  225. Disclaimer
  226. **********
  227.  
  228. This document and all versions of RayVerter are
  229. Copyright (C)1992 by Lonny L. Pursell and Encom
  230. All Rights Reserved.
  231.  
  232. RayVerter may not be sold.  It may, however, be freely distributed as
  233. long as this document is included and neither program nor document are
  234. modified in any way whatsoever.  This document may not be reprinted
  235. without prior permission from the author.
  236.  
  237. While every effort has been made to ensure that this program is free of
  238. bugs, I claim no responsiblity for any damage or loss of data resulting
  239. from the use or misuse of RayVerter.
  240.  
  241.  
  242. Revision history
  243. ----------------
  244.  
  245.   v1.00u  first release
  246.  
  247.